home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / fp12s.zip / FIDOPCB.DOC < prev    next >
Text File  |  1992-05-27  |  42KB  |  859 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  ┌─────────────────────────────────────────────────────┐
  9.  │ ██████  ▄▄      ██          ██████  ██████  ██████  │  Version: 1.2
  10.  │ ██              ██          ██  ██  ██      ██   ██ │  Release: 01.06.1992
  11.  │ ████    ██  ██████  ██████  ██████  ██      █████   │  Author : Matjaz Koce
  12.  │ ██      ██  ██  ██  ██  ██  ██      ██      ██   ██ │
  13.  │ ██      ██  ██████  ██████  ██      ██████  ██████  │  (c) MicroArt d.o.o
  14.  ├─────────────────────────────────────────────────────┤  1991-92
  15.  │  FidoPCB - FidoNet to PCBoard 14.x mail interface   │
  16.  └─────────────────────────────────────────────────────┘
  17.  
  18.  
  19.  
  20.   Lazy Sysop's rule:
  21.  
  22.       "Long manuals are never printed and read completely"
  23.  
  24.  
  25.  
  26.  
  27.                                                      FidoPCB 1.2  Page i
  28.  
  29.    -----=- Table of contents -=---------------------------------------
  30.  
  31.        Naming Conventions -=--------------------------------    ii
  32.        Distribution File -=---------------------------------    ii
  33.        Distribution Rules -=--------------------------------    ii
  34.        Contacting the Author -=-----------------------------   iii
  35.        Shareware -=-----------------------------------------   iii
  36.        Unregistered Shareware version -=--------------------   iii
  37.        Overview -=------------------------------------------     1
  38.        Limitations -=---------------------------------------     2
  39.        Installation and Setup -=----------------------------     3
  40.        Command line parameters -=---------------------------     5
  41.        Configuration file -=--------------------------------     7
  42.        Lost Mail -=-----------------------------------------    13
  43.        Handling NetMail -=----------------------------------    14
  44.        Running FidoPCB as a DOOR -=-------------------------    16
  45.        Areafix -=-------------------------------------------    17
  46.        Support and distribution nodes -=--------------------    18
  47.        Copyrights, Trademarks and Warranty -=---------------    19
  48.        Credits -=-------------------------------------------    20
  49.  
  50.  
  51.  
  52.                                                      FidoPCB 1.2  Page ii
  53.  
  54.    -----=- Naming Conventions -=----------------------------------------------
  55.  
  56.    FidoPCB is distributed using the file naming convention of: FPvvb.aaa, 
  57.    where 'vv' stands for the version number (ie. 13 for version 1.3, 50 for 
  58.    version 5.0).  The 'b' refers to a letter code specifying (A)lpha, (B)eta 
  59.    or (S)hareware release versions (ie. The shareware release is distributed
  60.    as FPvvS.aaa).  The AAA suffix refers to the compression method used on the
  61.    distribution archive.  This may be ARC, ZIP, ARJ, etc.  When referring to
  62.    the distribution file in the documentation, it will usually be referred to
  63.    as the distribution archive. 
  64.  
  65.  
  66.    -----=- Distribution File -=-----------------------------------------------
  67.  
  68.    The following files should be present within the distribution archive:
  69.  
  70.       File           Description
  71.       ============   ========================================================
  72.       FILE_ID.DIZ    Archive description
  73.       MICROART.BBS   MicroArt BBS Description and Phone Numbers
  74.       ORDER.FRM      FidoPCB Order Form
  75.       HISTORY.DOC    File describing changes from version to version
  76.       FIDOPCB.DOC    The FidoPCB User's Manual
  77.       FIDOPCB.EXE    The executable program
  78.       FIDOPCB.CFG    Sample (self describing) configuration file
  79.       FIDOPCB        Sample DOOR file
  80.       LOST.          PCBoard message base for lost mail
  81.       LOST.NDX       Index file for LOST.
  82.       MATRIX.        PCBoard message base for NetMail
  83.       MATRIX.NDX     Index file for MATRIX.
  84.       RUNFD.BAT      Sample Batch used to run FrontDoor, PCBoard and FidoPCB
  85.       ============   ========================================================
  86.  
  87.    Alpha/Beta versions usually do not include the User's Manual.  The revision 
  88.    history file, HISTORY.DOC, is included however, and should be consulted to 
  89.    see brief descriptions of changes and fixes.  Please be sure to read this 
  90.    file if you are working with an alpha or beta version of FidoPCB! 
  91.  
  92.  
  93.    -----=- Distribution Rules -=----------------------------------------------
  94.  
  95.    Sysops MAY place 'ZIP Comments' in the FidoPCB distribution archive file if 
  96.    they normally do so with all their download files.  Sysops MAY place 
  97.    additional files (such as 'README.1ST' or 'BBS_AD') ONLY if file names 
  98.    don't conflict with the files already in the distribution archive (see 
  99.    previous sentence). 
  100.  
  101.    Distribution of the alpha and beta versions is restricted to those systems
  102.    with specific permission to distribute them.  Do not distribute any version
  103.    of FidoPCB except the unregistered shareware (FPvvS.aaa) version! 
  104.  
  105.  
  106.  
  107.                                                      FidoPCB 1.2  Page iii
  108.  
  109.    -----=- Contacting the Author -=-------------------------------------------
  110.  
  111.    Problems, questions, and suggestions should be directed to Matjaz Koce:
  112.  
  113.       Modem:         MicroArt BBS
  114.                      Node 1: +38 66 34 986  [1200-9600]
  115.                      Node 2: +38 66 33 816  [1200-2400]
  116.                      Node 3: +38 66 37 536  [1200-2400]
  117.  
  118.       Mail:          MicroArt d.o.o        Phone:  +38 66 24977
  119.                      Matjaz Koce           Fax:    +38 66 21275
  120.                      Marusiceva 5
  121.                      66000 Koper
  122.                      Slovenija
  123.  
  124.       EchoMail:      AdriaNet:    Sysops, Shareware, HomeMadeSW Conferences
  125.                      FidoNet:     FidoPCB, Enet.sysop Conferences
  126.                      SaltAir BBS: Sysop Chat, Net_mail, Utility
  127.  
  128.       NetMail:       2:380/100@FidoNet.org
  129.                      2:333/606@FidoNet.org
  130.  
  131.  
  132.    -----=- Shareware -=-------------------------------------------------------
  133.  
  134.    Since you've most likely read statements under the heading "Shareware" 
  135.    before, I won't bother going into the idea again.  Simply be aware that 
  136.    FidoPCB is Shareware (US$ 39, or 62 DEM for the 256 area version).  The
  137.    registered version has some additional features.  The ORDER.FRM file
  138.    contains the registration form and price information.  You can also send me
  139.    NET_MAIL, or leave a comment to the sysop on MicroArt BBS. 
  140.  
  141.    Any and all registered users may operate any current and future releases of 
  142.    FidoPCB v1.x (both registered and beta versions).  Both registered and beta 
  143.    versions are always available from MicroArt BBS and other support BBS's, 
  144.    and may be downloaded from MicroArt BBS as desired. 
  145.  
  146.    Registration will also give you access to the BBS support conference
  147.    called FidoPCB, to share your experiences with other registered users.
  148.    In this conference you can also make suggestions, report bugs (I hope
  149.    this won't happen), and so on.
  150.  
  151.  
  152.    -----=- Unregistered Shareware version -=----------------------------------
  153.  
  154.    Running FidoPCB will indicate whether you are using the shareware [NR]
  155.    or registered [Serial#] version.  The unregistered version will accept a 
  156.    maximum of 20 configured areas.  The Tearline will also indicate that
  157.    you're using '---FidoPCB [NR]'.  There are no other limitations in the
  158.    unregistered versions of FidoPCB.
  159.  
  160.  
  161.  
  162.                                                      FidoPCB 1.2  Page 1
  163.  
  164.    -----=- Overview -=--------------------------------------------------------
  165.  
  166.    FidoPCB is a utility used to import/export FidoNet type messages into 
  167.    PCBoard message bases.  Messages are transferred between many different 
  168.    BBS's in, so called, Fido FTS-2 type packets. FidoPCB's features include: 
  169.  
  170.     - Unpacking of compressed packets (ZIP, ARC, ARJ, LHA formats)
  171.     - Importing of PKT files containing messages for various AREAS (without 
  172.       conversion into MSG format) into PCBoard message bases
  173.     - Exporting of new messages from PCBoard message bases
  174.     - Packing of exported messages
  175.     - Create the necessary MSG files for FrontDoor (send file, hold file)
  176.     - Create the necessary OUT file for BinkleyTerm
  177.     - Support for up to 10 AKA Aliases
  178.     - Bi-directional NetMail (private FidoNet mail) handling.
  179.     - Recognition of CRASH, DIRECT, INTL and other FidoNet message flags
  180.     - Handling of AreaFix commands (if you are a host, new areas can be 
  181.       connected or removed automatically) with connection security levels
  182.       and passwords
  183.     - Support for networks and multinode PCBoard systems with file sharing
  184.     - Configurable as a DOOR (requires a Fossil driver)
  185.     - Duplicate Message checking
  186.     - Recognition of ^aINLT and ^aFMPT flags for imported NetMail messages
  187.     - Recognition and support of PCBoard's "Private" message flag
  188.  
  189.    All of these, and other features can be used with multiple aliases (AKAs). 
  190.  
  191.  
  192.  
  193.                                                      FidoPCB 1.2  Page 2
  194.  
  195.    -----=- Limitations -=-----------------------------------------------------
  196.  
  197.    As mentioned, the unregistered version will handle only 20 configured 
  198.    areas.  Registered versions of FidoPCB can handle 256, 512, 1024 or more
  199.    message areas, depending on your needs.
  200.  
  201.    By setting FILES=65 or higher in CONFIG.SYS, FidoPCB will be able to
  202.    process mail for 30 configured nodes (if you are working as HUB or HOST).
  203.    Future versions will have limitations dependent on the FILES setting, and
  204.    available memory only.
  205.  
  206.    FidoPCB doesn't check how much disk space is available, so be sure that 
  207.    there is at least 1Mb or more free space available (depending on your 
  208.    packet size, and the number of configured Nodes and areas).  Your system
  209.    should have at least 350K of free RAM available, mainly to run archivers
  210.    like PKUNZIP, etc.  For exact memory requirements, please 
  211.    check the manual for the appropriate archiver(s) for details. 
  212.  
  213.    FidoPCB can handle messages of up to 64Kb.  Future versions will be able to 
  214.    accomodate messages of unlimited size. 
  215.  
  216.  
  217.  
  218.                                                      FidoPCB 1.2  Page 3
  219.  
  220.    -----=- Installation and Setup -=------------------------------------------
  221.  
  222.    Included in the distribution archive, is a sample configuration
  223.    file.  I advise you to use it as an example.  You should also have 
  224.    experience using PCBSETUP, as you'll have to install two additional
  225.    conferences (Matrix and Lost Mail).  This will be discussed later in this
  226.    Manual.  Also be sure you placed the directory containing the various
  227.    archivers (PKUNZIP, PKZIP, ARJ...) in your search PATH.  Alternately, you 
  228.    can define their locations in the FIDOPCB.CFG file.
  229.  
  230.    Throughout this manual, the directory where FidoPCB resides in, is
  231.    referred to as FIDOPCB.  You may change this if you wish.  The 
  232.    Installation is divided into four steps (#3 is the longest :->):
  233.  
  234.    1)   Create the FIDOPCB directory, and change to it with the CD command
  235.    2)   Extract FPvvb.aaa: FIDOPCB.EXE - executable code
  236.                            FIDOPCB.CFG - sample configuration file
  237.                            FIDOPCB.DOC - The User's Manual
  238.                            RUNFD.BAT   - sample BAT file for FrontDoor
  239.                            MATRIX.*    - message base and its index
  240.                            LOST.*      - message base and its index
  241.    3.1) Using a text editor, edit the FIDOPCB.CFG configuration file.
  242.         Lines should end with LF/CR. DON'T use tabs: CHR(9)!
  243.  
  244.         The configuration file is 'self describing'.  All of the commands
  245.         and parameters are discussed in the Manual.  Don't forget to set 
  246.         up all of the conferences you entered in the configuration file
  247.         under the AREA parameter, with PCBSetup.  You must also go into 
  248.         PCBoard and join them, in order to create the respective MSGS and 
  249.         MSGS.NDX files if they don't already exist. 
  250.  
  251.    3.2) Create an area with PCBSetup, where lost mail should be placed.
  252.         Use the directory you specified with the LOST_MAIL command in 
  253.         FIDOPCB.CFG.  Copy the LOST.* files to that directory.
  254.    3.3) Create an area with PCBSetup, where NetMail should be placed.  Use
  255.         the directory you specified with the NET_MAIL command in
  256.         FIDOPCB.CFG.  Copy the MATRIX.* files to that directory.
  257.    3.4) Run FIDOPCB with the SET ALL TOP commands to both check for errors
  258.         in the configuration (they will be reported), and to set all of the
  259.         Last Message Read (LMR) pointers.  If an error is reported, repeat
  260.         step 3.1
  261.    3.5) Select one area as a 'test area', and enter some (at least two) 
  262.         messages via PCBoard (do not use messages with *Origin lines, unless
  263.         you're using the FORCE parameter on the FidoPCB command line!)
  264.    3.6) Run FIDOPCB with the EXPORT parameter to export the test messages
  265.    3.7) Check the results by looking in the directories specified with the
  266.         PACKET and MAIL commands in FIDOPCB.CFG, and examining FIDOPCB.STA.
  267.         If nothing is there, repeat step 3.
  268.  
  269.  
  270.  
  271.                                                      FidoPCB 1.2  Page 4
  272.  
  273.    -----=- Installation and Setup -=------------------------------------------
  274.  
  275.    4)   Include FIDOPCB in your BAT files for events (see sample RUNFD.BAT)
  276.    5)   Install FidoPCB as DOOR (Optional)
  277.  
  278.    If you are unable to set up FidoPCB, mail me at my BBS.  I'll be there
  279.    to help you.
  280.  
  281.  
  282.  
  283.                                                      FidoPCB 1.2  Page 5
  284.  
  285.    -----=- Command line parameters -=-----------------------------------------
  286.  
  287.    Running FIDOPCB.EXE without parameters or with the /? switch will display 
  288.    all of the available command line parameters on the screen.  FidoPCB needs 
  289.    only simple information on the command line in order to run.  Most of the 
  290.    information is read from FIDOPCB.CFG. 
  291.  
  292.    Syntax: FIDOPCB [/?] [command] [areaname] [areanumber] [switch]
  293.         /? Displays a short description of all commands and switches
  294.         Valid commands are: EXPORT, IMPORT, TOSS, SET, LIST, STAT
  295.         Valid switches are: FORCE, RESET, STRIP
  296.  
  297.    Commands:
  298.  
  299.    EXPORT - Exports all new messages (since the last execution of FIDOPCB),
  300.             and updates the Last Message Read (LMR) pointers
  301.    IMPORT - Looks for new Mail Packet files in the FILES directory, and
  302.             imports them into the apropriate PCBoard message bases.  It
  303.             also updates the LMR pointers, regardless of there being any
  304.             messages to export
  305.    TOSS   - Combines the functions of the IMPORT and EXPORT commands by
  306.             exporting all new messages, and looking for new Mail Packet
  307.             files, importing them if found, and then updating the LMR
  308.             pointers
  309.    SET    - The syntax for the SET command is:
  310.                        SET <areaname>/ALL <number>/TOP
  311.             It sets the LMR pointer for <areaname>, or for all areas if you
  312.             specify the ALL parameter.  Using the TOP parameter instead of
  313.             a number will set LMR pointer to the highest message.  You may
  314.             use negative numbers to roll back the LMR pointer(s) from the
  315.             current value, by the number indicated (the number is subtracted
  316.             from the high message number).  If the number is above the
  317.             highest message, the highest message number will be used.
  318.    LIST   - The syntax for the LIST command is:
  319.                        LIST <areaname>/ALL
  320.             It lists the LMR pointer(s) and area types.  Using the ALL
  321.             parameter instead of <areaname> lists all areas.
  322.    STAT   - Displays statistics for all inbound/outbound mail
  323.  
  324.    Switches:
  325.  
  326.    DOOR   - Works only with a Fossil driver installed, and requires 
  327.             access to PCBOARD.SYS.  It can be used with all of the
  328.             other commands and switches.
  329.    RESET  - used with the STAT command to reset statistics to 0
  330.    STRIP  - Converts all characters above CHR(128) into asterisks (*).
  331.             Used with the EXPORT and TOSS commands.
  332.    FORCE  - Overrides checking for "Origin:"  lines.  The purpose of
  333.             checking for these lines is to avoid sending out received
  334.             messages.  Used with the EXPORT and TOSS commands.
  335.  
  336.  
  337.  
  338.                                                      FidoPCB 1.2  Page 6
  339.  
  340.    -----=- Command line parameters -=-----------------------------------------
  341.  
  342.    Examples:
  343.  
  344.    FIDOPCB LIST ALL         - Lists all areas (name, LMR pointer, type)
  345.    FIDOPCB STAT             - Shows import/export statistics
  346.    FIDOPCB STAT RESET       - Resets statistics for all areas to 0
  347.    FIDOPCB SET Net_Mail TOP - Sets LMR pointer in MATRIX to the
  348.                               highest message
  349.    FIDOPCB SET ALL -10      - Sets LMR pointer to <current>-10 in all areas
  350.    FIDOPCB SET FIDOTEST 1   - Sets LMR pointer in the FIDOTEST area to 1
  351.    FIDOPCB TOSS STRIP       - Looks for MO?, TH?, etc., and imports them 
  352.                               into PCBoard.  Routes messages in PKT files
  353.                               to other nodes as defined in FIDOPCB.CFG.
  354.                               Exports all new messages from PCBoard into
  355.                               PKT files, converting all characters with a
  356.                               value above CHR(128) (Ç) to asterisks (*).
  357.    FIDOPCB EXPORT FORCE     - Exports all new messages from PCBoard into
  358.                               PKT files, including messages with 
  359.                               "* Origin:" lines in the body text, which
  360.                               are not exported by default.
  361.    FIDOPCB IMPORT           - Scans for MO?, TH?, etc. files, and imports
  362.                               them into PCBoard.
  363.    FIDOPCB TOSS DOOR        - Imports/Exports all messages.  Output is 
  364.                               sent to the modem instead of a file.
  365.  
  366.  
  367.  
  368.                                                      FidoPCB 1.2  Page 7
  369.  
  370.    -----=- Configuration file -=----------------------------------------------
  371.  
  372.    FIDOPCB.CFG contains the configuration for FidoPCB.  The configuration file 
  373.    can, and should be created with a standard text editor such as QEdit, 
  374.    PCWrite, or EDLIN.  Never use Word Processors such as Word, WordStar or 
  375.    WordPerfect, since they may put additional, unwanted characters into what 
  376.    should be a standard ASCII text file.   Maximum line length is 1024 
  377.    characters.
  378.  
  379.    Lines starting with a semi-colon (;) are ignored.  Each command should be 
  380.    specified on a separate line, and no TAB characters (CHR(9)) should be 
  381.    imbedded on the line.  The sample FIDOPCB.CFG included in the distribution 
  382.    archive should be used as a point of reference. 
  383.  
  384.    Do NOT leave any blank lines between commands.  Because blank lines are 
  385.    ignored, FidoPCB will point to the wrong line number if an error should 
  386.    occur.  If you place a semi-colon on otherwise blank lines, then FidoPCB 
  387.    will be able to point to the correct line. 
  388.  
  389.    Future versions of FidoPCB will include a configuration program in order to 
  390.    ease the configuration process. 
  391.  
  392.    Valid commands are: ORIGIN, TAG, SYSOP, NODE, AREA, AREA_MSGS, MAIL,
  393.                        IGNORE_ECHO, PACKET, WORK, FILE, COMPRESS, FLOW_TYPE, 
  394.                        AKA, USE_AKA, AKA_TAG, INTERFACE, NET_TOSS, NETWORK,
  395.                        LOST_MAIL, NET_MAIL, PCBOARD, FRONTDOOR, ZIP,
  396.                        UNZIP, ARC, UNARC, ARJ, UNARJ, LZH, UNLZH, MAX_MSGS,
  397.                        DUPE_CHECK, DOMAIN, BAD, NO_BELL, AREA_LEVEL,
  398.                        NODE_LEVEL, PASSWORD, AKA_DOMAIN
  399.  
  400.    Most of the commands have default values so it isn't necessary to use them 
  401.    in your configuration file. 
  402.  
  403.   Commands are separated into six groups: Directory Descriptions, Archiver 
  404.    Definitions, Area Descriptions, Node Descriptions, Strings, and Switches. 
  405.    Some are strictly connected.  For instance:
  406.        AREA_MSGS, AREA_LEVEL follow the AREA command
  407.        NODE_LEVEL, SYSOP, COMPRESS, FLOW_TYPE, USE_AKA follow the NODE
  408.        command
  409.        AKA_TAG,AKA_DOMAIN follow the AKA command
  410.        SYSOP follows the ORIGIN and NODE command
  411.  
  412.    DIRECTORY DESCRIPTIONS: Limited to 64 characters per description, and
  413.                 the described directory must exist when FidoPCB is run.
  414.  
  415.    Command      Description
  416.    ───────────  ─────────────────────────────────────────────────────────────
  417.    FILE         path to inbound packets    (where received files are placed)
  418.    PACKET       path to outbound packets (where outgoing packets are placed)
  419.    MAIL         path to *.MSG             (where FrontDoor finds .MSG files)
  420.    BAD          path to bad packets   (used for packets that contain errors)
  421.  
  422.  
  423.  
  424.                                                      FidoPCB 1.2  Page 8
  425.  
  426.    -----=- Configuration file -=----------------------------------------------
  427.  
  428.    Command      Description
  429.    ───────────  ─────────────────────────────────────────────────────────────
  430.    WORK         path to FidoPCB's work directory    (a RAM disk if possible)
  431.    LOST_MAIL    path to LOST.*    (PCBoard area where lost mail is imported)
  432.    NET_MAIL     path to MATRIX.*    (PCBoard area where NetMail is imported)
  433.                      ** Remember: The recipient's Net address goes on the
  434.                                   first line of a message
  435.    PCBOARD      path to PCBOARD.SYS   (created by PCBoard for running Doors)
  436.    FRONTDOOR    path to FrontDoor files   (used to generate semaphore files)
  437.  
  438.    Examples:  MAIL     c:\front\mail
  439.               PACKET   f:\microart\pcb\fidopcb\packet
  440.               PCBOARD  m:\pcb
  441.  
  442.  
  443.    SWITCHES: Enable or disable certain functions and features.  Defaults are
  444.                 the first listed settings listed in the table.
  445.  
  446.    Command      Switches    Description
  447.    ───────────  ──────────  ─────────────────────────────────────────────────
  448.    INTERFACE    NONE        FidoNet interface program you are using.
  449.                 BINKLEY
  450.                 FRONTDOOR
  451.    NET_TOSS     PCBOARD     System to which NetMail is sent.  Setting this to 
  452.                 FRONTDOOR   'Both' places mail in both PCBoard and FrontDoor.
  453.                 BOTH
  454.    NETWORK      OFF         When enabled, allows File Locking.  For use with
  455.                 ON          Multitasking and multiple Node environments.
  456.    NO_BELL      OFF         When enabled, FidoPCB will beep when an error is
  457.                 ON          encountered while packets are being processed.
  458.                             If you use LANTastic or NOS 4.0, this feature
  459.                             should be disabled.
  460.    IGNORE_ECHO  ON          Exports only those messages with PCBoard's Echo
  461.                 OFF         flag set.  If disabled, all messages are exported.
  462.    MAX_MSGS     9999        Specifies the number of messages to export at one
  463.                             time.  The valid range is 1-9999.
  464.    DUPE_CHECK   200         Specifies the number of messages that are checked
  465.                             for duplication in areas specified with the DUPE
  466.                             switch in the AREA declarations.  FidoPCB checks
  467.                             the From, To, Subj, Date, Time and ^aMSGID fields.
  468.                             Also checked, are the first ten characters of
  469.                             messages.  Any duplicates will be copied into
  470.                             the LOST mail conference.  The valid range
  471.                             is 1-9999.
  472.  
  473.  
  474.  
  475.  
  476.                                                      FidoPCB 1.2  Page 9
  477.  
  478.    -----=- Configuration file -=----------------------------------------------
  479.  
  480.    Command      Switches    Description
  481.    ───────────  ──────────  ─────────────────────────────────────────────────
  482.    COMPRESS     ZIP         Compression method to be used on Outbound, as well
  483.                 ARC         as inbound echomail packets.
  484.                 ARJ
  485.                 LZH
  486.  
  487.    Examples:  INTERFACE  frontdoor
  488.               NETWORK    off
  489.               NET_TOSS   both
  490.  
  491.  
  492.    STRINGS: These definitions are used to identify your system and messages 
  493.                 that originate from it.
  494.  
  495.    Command      Description
  496.    ───────────  ─────────────────────────────────────────────────────────────
  497.    ORIGIN       Your node's main address.  Format: Z:NNN/SSS (Zone:Net/Node)
  498.    DOMAIN       The UUCP organization identifier that is appended to the
  499.                 ^aMSGID flag of messages originating on your system.  It can
  500.                 be up to 20 characters long.  The default is "fidonet.org".
  501.    SYSOP        Name of the SysOp whose system is specified by the ORIGIN
  502.                 and NODE commands.
  503.    TAG          The string that will be appended to all messages originating
  504.                 at your main Net Address.
  505.    AKA          Alias addresses by which your system is known.  Up to 10 AKA
  506.                 aliases may be defined.  Strictly connected to the AKA_TAG
  507.                 command.
  508.    AKA_TAG      The string that will be appended to all messages originating
  509.                 at your AKA Address.
  510.    AKA_DOMAIN   The UUCP organization identifier that is appended to the
  511.                 ^aMSGID flag of messages originating on your system.  It can
  512.                 be up to 20 characters long.  The default is "fidonet.org".
  513.  
  514.    Examples:  ORIGIN     2:380/100
  515.               DOMAIN     fidonet.org
  516.               SYSOP      Gregor Rudolf
  517.               AKA        1   2:333/606
  518.               AKA_TAG    We are the best in Koper, Slovenija (2:333/606)
  519.               AKA DOMAIN fidonet.org
  520.  
  521.  
  522.  
  523.                                                      FidoPCB 1.2  Page 10
  524.  
  525.    -----=- Configuration file -=----------------------------------------------
  526.  
  527.    ARCHIVER DEFINITIONS:  These definitions are used to identify the location 
  528.                 and names of your archiving utilities.  If you already have 
  529.                 that location listed in your PATH statement, then use of these 
  530.                 definitions is not required.  If you need to use them, it 
  531.                 isn't necessary to include commandline switches, as they are 
  532.                 already coded into FidoPCB.  The proper syntax for using these 
  533.                 definitions is: <drive>:\[path]<utility name>
  534.  
  535.    Command      Purpose                         Requires   Embedded Switches
  536.    ───────────  ──────────────────────────────  ─────────  ──────────────────
  537.    ZIP          Generate ZIP format archives    PKZIP      -M
  538.    UNZIP        Extract ZIP format archives     PKUNZIP    -O
  539.    ARC          Generate ARC format archives    PKARC      -R
  540.    UNARC        Extract ARC format archives     PKXARC     -M
  541.    ARJ          Generate ARJ format archives    ARJ        M
  542.    UNARJ        Extract ARJ format archives     ARJ        E -U
  543.    LZH          Generate LZH format archives    LHA        M
  544.    UNLZH        Extract LZH format archives     LHA        E
  545.  
  546.    Examples:  ZIP    c:\utility\pkunzip.exe
  547.               UNARC  m:\archiver\pkxarc.exe   
  548.               ARJ    c:\arj.exe               
  549.               UNARJ  c:\arj.exe               
  550.               UNLZH  d:\lharc\lha.exe         
  551.  
  552.    AREA DESCRIPTION: Definitions for message area routing.  These commands
  553.                 require multiple parameters in one line, and are strictly
  554.                 connected to additional commands.
  555.  
  556.    Command      Parameters  Description                         Connected to
  557.    ───────────  ──────────  ──────────────────────────────────  ─────────────
  558.    AREA         number      Area identifier for connection to   AREA_MSGS
  559.                             the NODE parameter. (Range: 1-127)
  560.                 name        FidoNET's name for the area, as
  561.                             listed in the comprehensive Areas
  562.                             directory (ELISTvvv.aaa).
  563.                 path        Path to the PCBoard Message file.
  564.                 NOMSGS      If used, declares the area to be
  565.                             a pass-through area.
  566.                 DUPE        Enables duplicate checking in the   DUPE_CHECK
  567.                             the area.  A control file using 4
  568.                             bytes/checked message is created.
  569.    AREA_LEVEL   number      Sets a security level for use by    NODE_LEVEL
  570.                             AreaFix to forward the area.  The
  571.                             valid range is 1-9999.  Default: 0
  572.  
  573.  
  574.  
  575.  
  576.                                                      FidoPCB 1.2  Page 11
  577.  
  578.    -----=- Configuration file -=----------------------------------------------
  579.  
  580.    Command      Parameters  Description                         Connected to
  581.    ───────────  ──────────  ──────────────────────────────────  ─────────────
  582.    AREA_MSGS    filename    The PCBoard message file name.  If
  583.                             not defined, the default is MSGS
  584.  
  585.    Example:   AREA   1   Clipper       d:\pcb\clipper  DUPE
  586.               AREA_MSGS  Clip
  587.               AREA  99   For_node_603  d:\pcb          NOMSGS
  588.  
  589.  
  590.    NODE DESCRIPTION: Descriptors for message packet routing.  These commands 
  591.                 require multiple parameters in one line, and are strictly 
  592.                 connected to additional commands. 
  593.  
  594.    Command      Parameters  Description                        Connected to
  595.    ───────────  ──────────  ─────────────────────────────────  ──────────────
  596.    NODE         address     Host Node's address (Z:NNN/SSS)    SYSOP,
  597.                 areas       The area number(s) tied to this    COMPRESS,
  598.                             Node.  Area numbers must be        FLOW_TYPE,
  599.                             defined with the AREA command!     USE_AKA
  600.                             Individual areas can be separated
  601.                             by commas, and consecutive areas,
  602.                             ranged with hyphens.  If no areas
  603.                             are defined, packets are created
  604.                             containing all areas.
  605.    NODE_LEVEL   number      Sets a security level for use by    AREA_LEVEL
  606.                             AreaFix to forward areas with an 
  607.                             equal or lower security level to  
  608.                             the node.  Valid range is 1-9999.
  609.                             Default: 0
  610.    PASSWORD     string      The AreaFix password used by this
  611.                             node.  Limit: 20 characters.
  612.    SYSOP                    Name of the SysOp whose system is
  613.                             specified by the NODE command.
  614.    COMPRESS     mode        Compression method to used on
  615.                             packets to/from this node.  The
  616.                             default is ZIP.  Valid parameters
  617.                             are ZIP, ARC, ARJ, LHA.
  618.    FLOW_TYPE    flag        Outbound packet status flag.  The
  619.                             default is NORMAL.  Flags are:
  620.                             NORMAL, HOLD, IMMEDIATE, CRASH.
  621.  
  622.  
  623.  
  624.  
  625.                                                      FidoPCB 1.2  Page 12
  626.  
  627.    -----=- Configuration file -=----------------------------------------------
  628.  
  629.    Command      Parameters  Description                        Connected to
  630.    ───────────  ──────────  ─────────────────────────────────  ──────────────
  631.    USE_AKA      number      Predefined AKA to be used on    
  632.                             packets sent to this node.  AKA's
  633.                             are defined with the AKA Command!
  634.  
  635.    Example:   NODE       2:333/600       1-3,7,15
  636.               NODE_LEVEL 3
  637.               PASSWORD   fidopcb
  638.               SYSOP      Maurizio Biondi
  639.               COMPRESS   ZIP
  640.  
  641.  
  642.  
  643.                                                      FidoPCB 1.2  Page 13
  644.  
  645.    -----=- Lost Mail -=-------------------------------------------------------
  646.  
  647.    LOST, and the index LOST.NDX, make up the PCBoard compatible message base 
  648.    that contains mail from any areas not defined in FIDOPCB.CFG.  Look at it 
  649.    occasionally, or set up it in PCBSETUP, since it is one of the indicators 
  650.    of your system being set up correctly on your end. 
  651.  
  652.    Area names defined in FIDOPCB.CFG with the AREA parameter, are compared 
  653.    with the names found inside the packets.  If FidoPCB finds messages 
  654.    directed to an area that wasn't defined, it puts those messages into the 
  655.    LOST message base. 
  656.  
  657.    The first line of all messages placed in LOST, are saved with the 
  658.    statement, AREA: <areaname> in the first line.  That way, you will be
  659.    able to locate problem.
  660.  
  661.    Duplicate messages are also placed in LOST, and are saved with the 
  662.    statement, DUPLICATE, on the first line, and AREA: <areaname> on the
  663.    second line.  This permits you to to check the messages, and move or
  664.    kill them.
  665.  
  666.  
  667.  
  668.  
  669.                                                      FidoPCB 1.2  Page 14
  670.  
  671.    -----=- Handling NetMail -=------------------------------------------------
  672.  
  673.    MATRIX, and the index MATRIX.NDX, make up the PCBoard compatible message 
  674.    base file containing NetMail messages (private FidoNet messages).  If you 
  675.    are using FrontDoor, FidoPCB scans for new .MSG files and imports them to 
  676.    the MATRIX conference in PCBoard.  Compressed NetMail messages are imported 
  677.    automatically without using .MSG files. 
  678.  
  679.    When you enter NetMail messages, you must enter the recipient's network 
  680.    address at the start of the first line using the format: (Z:NNN/SSS.PPP)
  681.                         Z = Zone number (Default = 2)
  682.                         N = Net number
  683.                         S = Site (Node) number
  684.                         P = Point number (optional)
  685.  
  686.    Don't forget to enclose the address in parenthesis "()", as FidoPCB only 
  687.    checks for this format!  MATRIX messages are then converted to the .MSG 
  688.    format used by FrontDoor, so you can review them.  Exported messages are 
  689.    placed in the directory you specified with the MAIL command in FIDOPCB.CFG, 
  690.    from where they are routed by FrontDoor. 
  691.  
  692.    To add special flags to a message, add one of the following commands, 
  693.    enclosed in parenthesis "()", at the start of the second line: HOLD, IMM, 
  694.    CRASH, INTL.  Multiple flags can be entered by separating them with a comma 
  695.    (,) and no trailing spaces.
  696.  
  697.    Flag   Description
  698.    ─────  ───────────────────────────────────────────────────────────────────
  699.    HOLD   Causes FrontDoor to put this message on hold.
  700.    IMM    Causes the message to be forwarded immediately.
  701.    CRASH  Forces FrontDoor to forward this message directly to the recipient.
  702.    INTL   Forces the message to be routed via the Zone Gate, to recipients 
  703.           outside your zone.  Do not use this flag in conjunction with the 
  704.           CRASH flag.
  705.  
  706.    Example:
  707.    ===================================================
  708.    To: ALL                              Date: 10.10.91
  709.    From: Gregor Rudolf                  Time: 12:13:11
  710.    Subj: Just sampling...               Read: NO
  711.    Conf: MATRIX (54)
  712.  
  713.    (2:380/101)                     <- recipient's address
  714.    (IMM,CRASH)                     <- special flags
  715.    This is only a sample message.
  716.    =====================================================
  717.  
  718.    If you have NET_TOSS set to BOTH in the configuration file, DO NOT use FM 
  719.    to read messages, as this will generate duplicates in the MATRIX conference 
  720.    in PCBoard.
  721.  
  722.  
  723.  
  724.                                                      FidoPCB 1.2  Page 15
  725.  
  726.    -----=- Handling NetMail -=------------------------------------------------
  727.  
  728.    The first line of all received messages will contain the sender's address, 
  729.    in the format: FROM:(Z:NNN/SSS.PPP).  This allows you to see the sender's 
  730.    address and facilitate your replies.  Messages in this conference will also 
  731.    include all additional lines extracted from the message header, including 
  732.    the ^aMSGID, ^aINLT and ^aFMPT lines.
  733.  
  734.  
  735.  
  736.  
  737.                                                      FidoPCB 1.2  Page 16
  738.  
  739.    -----=- Running FidoPCB as a DOOR -=---------------------------------------
  740.  
  741.    FidoPCB can be configured to run as a DOOR.  This mode will allow you and 
  742.    you users to process mail independently from FrontDoor and other events. 
  743.    Two things are needed to set FidoPCB up as a DOOR: First, you must have a 
  744.    Fossil Driver such as BNU or X00 installed on your computer.  Second, the 
  745.    PCBOARD.SYS file generated by PCBoard should be in the directory defined by 
  746.    the PCBOARD command in FIDOPCB.CFG. 
  747.  
  748.    Create a batch file using the sample FIDOPCB file as an example.  Then, 
  749.    using PCBSetup's Main Conference (and/or a conference specific) Door Paths 
  750.    editor, create an entry for the door.  You may set the Password, Security 
  751.    and Shell options as you desire.  The LOGIN, USER.SYS and DOOR.SYS options 
  752.    must be set to NO. 
  753.  
  754.    FidoPCB obtains all the necessary information from PCBOARD.SYS.  The 
  755.    program also generates the two semaphore files used by FrontDoor, a
  756.    function that is of particular help in the case of multinode systems. 
  757.  
  758.    You may want to restrict access to the FidoPCB door on your system, to 
  759.    prevent abuse, and to keep dummy NetMail and duplicate messages from 
  760.    circulating around the world.  On my system, for instance, only a few users 
  761.    have a security level high enough to run the FidoPCB door.
  762.  
  763.  
  764.  
  765.  
  766.                                                      FidoPCB 1.2  Page 17
  767.  
  768.    -----=- Areafix -=---------------------------------------------------------
  769.  
  770.    Areafix is active when you're operating as a HOST or HUB and Access to it 
  771.    is allowed only for configured nodes.  It allows all of your configured 
  772.    nodes to list, select and deselect available areas on your node, with a 
  773.    simple NetMail message.  Areafix messages should be addressed to Areafix.  
  774.    The subject of the message should include your AreaFix password, and the
  775.    optional "-q" switch in order to generate a list of selected areas.
  776.  
  777.    Areas are activated by entering their name in the body text.  To turn off
  778.    active areas, this name should be preceded with a hyphen (-).
  779.  
  780.    Example:    From: Matjaz Potrc, MojsteR BBS (2:380/101)
  781.                To:   Areafix, MicroArt BBS (2:380/100)
  782.                Subj: fidopcb -q
  783.                -------------------------------------------
  784.                Clipper
  785.                -C_Echo
  786.  
  787.  
  788.  
  789.  
  790.                                                      FidoPCB 1.2  Page 18
  791.  
  792.    -----=- Support and distribution nodes -=----------------------------------
  793.  
  794.    All FidoPCB support BBS's carry the FidoPCB echo conference.  You can find 
  795.    the most recent releases of the Beta and Shareware versions of FidoPCB, on 
  796.    both the support and distribution sites.  If you have any problems with the 
  797.    program, simply join the support conference.  My partners and I will answer 
  798.    your questions.  We only ask that you be patient in waiting for your 
  799.    answers.
  800.  
  801.    The following, is a list of FidoPCB support boards around the world:
  802.  
  803.    Country   Board Name              FidoNET    Phone            Protocols
  804.    ────────  ──────────────────────  ─────────  ───────────────  ────────────
  805.    Slovenia  MicroArt BBS            2:380/100  +38 66 349-86    V.32
  806.              MojsteR BBS             2:380/101  +38 68 237-31    V.32bis
  807.    Italy     Fido_TS_1               2:333/603  +39 40 378-3111  V.32bis/HST
  808.    USA       The Sweet Life PCBoard  1:102/815  1 818 882-9058   V.32bis/HST
  809.              NETRef BBS              1:273/214  1 215 736-1889   V.32bis/HST
  810.    Canada    Innovatron              1:240/333  1 819 893-9682   V.32bis/HST
  811.  
  812.  
  813.  
  814.  
  815.                                                      FidoPCB 1.2  Page 19
  816.  
  817.    -----=- Copyrights, Trademarks and Warranty -=-----------------------------
  818.  
  819.    All of the programs mentioned are copyrighted and/or trademarked by their 
  820.    respective authors.  Please refer to each program in order to determine the 
  821.    actual copyright/trademark owner(s) as appropriate or needed. 
  822.  
  823.       IN NO EVENT SHALL THE AUTHOR, MATJAZ KOCE, BE HELD RESPONSIBLE IN
  824.       ANY WAY, FOR THE BEHAVIOR OF ANY VERSION OF FIDOPCB.  NEITHER THE 
  825.       AUTHOR, OR ANY OTHER PARTY AUTHORIZED BY THE AUTHOR TO MODIFY AND 
  826.       DISTRIBUTE FIDOPCB, SHALL  BE  HELD LIABLE  FOR DAMAGES INCURRED,
  827.       INCLUDING ANY LOST INCOME,  AND/OR OTHER SPECIAL,  INCIDENTAL, OR 
  828.       CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE, OR INABILITY TO USE 
  829.       FIDOPCB.  THIS INCLUDES, BUT IS NOT LIMITED TO LOSS OF DATA, DATA
  830.       BEING RENDERED INACCURATE,  LOSSES SUSTAINED BY THIRD PARTIES, OR
  831.       A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS.  THE
  832.       ABOVE TERMS APPLY IN ALL CASES AND SITUATIONS, EVEN IF THE AUTHOR
  833.       HAS BEEN ADVISED OF  THE POSSIBILITY OF SUCH DAMAGES,  OR FOR ANY
  834.       CLAIM BY ANY OTHER PARTY. 
  835.  
  836.  
  837.  
  838.                                                      FidoPCB 1.2  Page 20
  839.  
  840.    -----=- Credits -=---------------------------------------------------------
  841.  
  842.    Thanks to:
  843.  
  844.    - All beta testers
  845.    - Gregor Rudolf, who helped me with advice.
  846.    - Damjan Pavlovec, Matjaz Potrc, George Silberstern and Mike Waldron, 
  847.                  for their help with the documentation.
  848.    - George Silberstern, for being providing user support in the USA
  849.    - Mosaic v1.0 and other PCBoard mailer/tossers, as their bugs, slow 
  850.                  processing, inabillities made me feel bad.  So much so, that 
  851.                  I decided to write a tosser of my own 
  852.  
  853.    Revision history can be found in the file, HISTORY.DOC, which is included 
  854.    in the FidoPCB distribution archive.
  855.  
  856.    PLEASE, SUPPORT SHAREWARE!
  857.    Thank you.
  858.  
  859.